home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / GSOS / TN.GSOS.006 < prev    next >
Encoding:
Text File  |  1991-01-11  |  2.2 KB  |  49 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. GS/OS
  8. #6:    Drivers and GS/OS Direct Page
  9.  
  10. Revised by:    Matt Deatherage                                   January 1991
  11. Written by:    Matt Deatherage                                     March 1989
  12.  
  13. This Technical Note corrects an error in the preliminary GS/OS documentation
  14. and provides an alternate suggestion for developers who are writing GS/OS
  15. drivers.
  16. Changes since September 1990:  Updated the list of calls which do not require
  17. the GS/OS direct page and updated the documentation references.
  18. _____________________________________________________________________________
  19.  
  20. Preliminary GS/OS documentation, including the beta draft of GS/OS Reference,
  21. Volume 2, incorrectly states that locations $5A through $5F are available for
  22. device drivers, and that locations $66 through $6B are shared by device
  23. drivers and supervisory drivers (and may be corrupted by either a driver or
  24. supervisory driver call).
  25.  
  26. This is not correct.  The locations in question are used by GS/OS; destroying
  27. these locations can cause system failure and media corruption.
  28.  
  29. Drivers which require direct page space of their own should request it from
  30. the Memory Manager when they are started.  Upon receiving a call, a driver can
  31. save the value of the D register (containing the GS/OS direct page) and switch
  32. to its own direct page.  The driver may keep the value of its direct page
  33. inside the driver itself; no space on GS/OS direct page is available for this
  34. purpose.  The driver must restore the D register to point to the GS/OS direct
  35. page before returning from the call, and it should also dispose of its direct
  36. page space when it shuts down.
  37.  
  38. The driver must also set the D register to point to the GS/OS direct page
  39. before making any system service call other than SET_SPEED, DYN_SLOT_ARBITER,
  40. MOVE_INFO, SIGNAL, and INSTALL_DRIVER.
  41.  
  42. Note:  The location of the GS/OS direct page is guaranteed to
  43.        remain the same between Driver_StartUp and Driver_ShutDown calls.
  44.  
  45.  
  46. Further Reference
  47. _____________________________________________________________________________
  48.     o    GS/OS Device Driver Reference
  49.